home *** CD-ROM | disk | FTP | other *** search
/ Risc World 3 / Risc World 3.iso / SOFTWARE / ISSUE4 / ZAP / !Zap / Modules / !NewMail / !Help next >
Text File  |  2002-09-02  |  5KB  |  147 lines
  1.  
  2.              ZapNewMail, a Zap syntax colouring mode
  3.              =======================================
  4.  
  5. 1.0 Features
  6. ============
  7.  
  8. Here is ZapNewMail, a Zap syntax colouring mode for dealing with mail.
  9.  
  10. I feel a bit like I am stepping on Darren Salt's territory here, so
  11. apologies to him, and here's hoping I keep him on his toes.
  12.  
  13. This mode was written because some aspects of Darren's mode did not suit
  14. me.  In particular I had difficulties in viewing mail files containing
  15. more than one message.  Darren's mode has improved in this respect since this
  16. mode was written.  Darren's mode is superior for editing mail in, and due
  17. the the flexibility allowed by Zap regarding the ways of choosing which
  18. files are edited in which mode, it is normally possible to allow OLE files
  19. from most mail/news program to be edited by Darren's mode while sending raw
  20. SMTP files directly to ZapNewMail.
  21.  
  22. My mode has a different style of syntax-colouring from Darren's.  It has not
  23. been the intention to duplicate the functionality of Darren's editing
  24. features, but rather to provide an alternative mail viewing environment.
  25. Note that some of the commands provided by Darren's module will work even if
  26. his mode is not currently displaying the file.
  27.  
  28. The module contains some enhancements to the cursor keys so that when
  29. they are used in combination with the shift key they behave in a more
  30. appropriate manner than when is in text mode.  These routines have been
  31. stolen from Martin Ebourne's C mode and are documented by him in his own
  32. directory.  Basically they make the shift-cursor combinations pause more
  33. frequently and more intelligently step through the code.  Martin has
  34. kindly given me his permission to use his code.
  35.  
  36. Although the author welcomes correspondence concerning this mode, he
  37. makes no claim that it is bug free and, it is not guaranteed to perform
  38. any particular function.  It is to be used entirely at one's own risk.
  39.  
  40. This is Freeware, and may be distributed freely provided that all the
  41. files remain intact.
  42.  
  43. 2.0 Installation
  44. ================
  45.  
  46. Copy the !NewMail application into the Zap.Modules directory, then restart Zap.
  47.  
  48.  
  49. Commands
  50. ~~~~~~~~
  51. NEWMAIL_FLAGSTOGGLE <word>
  52.  
  53. This has the same syntax as the WFORMAT_TOGGLE command.  It ticks menu
  54. entries if it is attached to them. This is used internally to generate
  55. the mode menu.
  56.  
  57. NEWMAIL_LISTSENDERS
  58.  
  59. This lists all the lines in the mail file starting with the text "From: "
  60. in a throwback buffer.
  61.  
  62. 3.0 History
  63. ===========
  64.  
  65. v1.13 - (02-Sep-2002)
  66.       * Bugfix to Scripts loading code
  67.  
  68. v1.12 - (29-Sep-99)
  69.       * Removed the bit which sends URLs on ctrl/alt+click. Partly because
  70.         rewriting now that SENDURLGIVENOFFSET has (sensibly) been ditched was
  71.         a hassle, but mostly because ClickSend does this happily on alt+double
  72.         click, which is more consistent. The code is still there, just never
  73.         called.
  74.  
  75. v1.11 - (15-Apr-97)
  76.       * Added LISTFNS and NEWMAIL_LISTSENDERS commands, and their associated
  77.     buttons.
  78.  
  79. v1.10 - (23-Mar-97)
  80.       * Added support for 'Window Wrap' and Buttons.
  81.       * Darren Salt's Alt/Ctrl - double-click protocol supported (this
  82.         depends for its action on ZapDS v0.29).
  83.       * Large numbers of improvements to the wrapping of text across line
  84.         ends.
  85.  
  86. v1.09 - (24-Feb-97)
  87.       * Added support for ZapButtons.  Note that some applications (instead
  88.         of using OLE) have been know to rely on the editor's window being at
  89.         the top of the window stack and perform their file transfer when
  90.         this was no longer the case.  ZapButtons' panes of tools will almost
  91.         certainly confuse this primitive mechanism; simplest to turn the
  92.         buttons off if there are problems.
  93.  
  94. v1.08 - (12-Jan-97)
  95.       * Cured RPC specific problem with starting from blank files in
  96.         ZapNewMail.
  97.  
  98. v1.07 - (06-Jan-97)
  99.       * The Zap command "OLEFILECHANGED" was added in error and then
  100.         quickly stripped out again (apologies).
  101.  
  102. v1.06 - (09-Dec-96)
  103.       * Logical line numbering bugs fixed.
  104.  
  105. v1.05 - (05-Dec-96)
  106.       * A couple more start of line markers added.
  107.  
  108. v1.04 - (19-Nov-96)
  109.       * Fix for bug involving lines containing things like "from:" and
  110.         "to:" from messing up the colouring on the next line.
  111.  
  112. v1.03 - (10-Nov-96)
  113.       * Fix for RPC owners who use !Zap with dynamic areas: a problem
  114.         sometimes occurred when SHIFT left-arrow was pressed at the
  115.         start of a file, or SHIFT right-arrow at the end of one.  I
  116.         have applied the solution to this problem to all my modes.
  117.  
  118. v1.02 - (05-Nov-96)
  119.       * Bug involving "&" and ";" characters (left over from my ZapHotMeal
  120.         module) removed.
  121.       * Massive internal changes to fix problems at end of lines.
  122.       * "X-" prefixed strings are now always coloured as commands.
  123.  
  124. v1.01 - (02-Nov-96)
  125.       * First release on the web.
  126.  
  127. v1.00 - (30-Nov-96)
  128.       * Very early release as a RFC to Dom Symes.
  129.  
  130.  
  131. 4.0 Contact
  132. =============
  133.  
  134.   Bug reports should be sent to 
  135.  
  136.         bugs@zap.tartarus.org
  137.  
  138.   Feature requests should be directed towards
  139.  
  140.         zap-features@zap.tartarus.org
  141.  
  142.  
  143. There are a also a number of mailing lists you can subscribe to - see
  144. Zap's web pages for details:
  145.  
  146.         http://zap.tartarus.org/
  147.